home *** CD-ROM | disk | FTP | other *** search
/ Visual Basic Toolbox / Visual Basic Toolbox (P.I.E.)(1996).ISO / error_hn / vbdocerr / vbdocerr.txt
Text File  |  1991-07-04  |  10KB  |  261 lines
  1. Q73655 Documentation Errors in First Printing of Visual Basic 1.0
  2. Microsoft Visual Basic (VBASIC)
  3. 1.00
  4. WINDOWS
  5.  
  6. Summary:
  7.  
  8. Below is a list of documentation errors in the first printing of
  9. manuals shipped with Microsoft Visual Basic version 1.0.
  10.  
  11. The documentation errors listed below have been corrected in the
  12. second printing of the Visual Basic manuals. Documentation errors
  13. that subsequently may be discovered in the second printing will be
  14. documented in separate articles here in the Microsoft Knowledge Base.
  15.  
  16. More Information:
  17.  
  18. Microsoft Visual Basic includes the following two manuals:
  19.  
  20.  - "Microsoft Visual Basic: Programmer's Guide"
  21.  
  22.  - "Microsoft Visual Basic: Language Reference"
  23.  
  24. In both manuals, all references to OS/2 and Presentation Manager (PM)
  25. are misprints, and should be ignored.
  26.  
  27. Corrections to the "Microsoft Visual Basic: Programmer's Guide"
  28. ---------------------------------------------------------------
  29.  
  30. (page 61) "To set the Caption property:" #2, last line:
  31.           "...you can skip Step 4 and proceed to Step 5." should read
  32.           "...you can skip Step 3 and proceed to Step 4."
  33.  
  34. (page 97) First line:
  35.           "...calls to the LogB procedure..." should read
  36.           "...calls to the LogF procedure..."
  37.  
  38. (page 117) Table at bottom of page, last two lines should be:
  39.  
  40.          Caption         CtlName           Indented        Index
  41.          -               SepBar              Once
  42.                          AppName             Once            0
  43.  
  44.         The following text should read:
  45.  
  46.        "Turn off the Visible property for AppName by toggling the
  47.         Visible check box. The SepBar control has its caption set to a
  48.         hyphen (-), which causes Visual Basic to display a separator
  49.         bar."
  50.  
  51. (page 118) Second paragraph, delete the following:
  52.         "Therefore, you cannot delete the...of Appname."
  53.  
  54.          Fourth paragraph, code should read:
  55.  
  56.          Sub AppName_Click (Index as Integer)
  57.            x = Shell(AppName(Index).Caption, 1)
  58.            Appname(LMenu).Visible = -1
  59.          End Sub
  60.  
  61.  
  62. (page 129) Last paragraph, first line:
  63.          "...tabbing to the button and..." should read
  64.          "...tabbing to the option button group, using the arrow keys,
  65.           and..."
  66.  
  67. (page 146) Top:
  68.          "MsgBox msg$[,type%[,type%[,title$]]"  should read
  69.          "MsgBox msg$[,type%[,title$]]"
  70.  
  71. (page 153) Lines 8 through 14:
  72.          All references to CurrentX should be CurrentY and vice versa
  73.  
  74. (page 170) Code at bottom of page:
  75.          Text1(I).Text = "Text1(" + Format(I) + ")"  should read
  76.          Text1(I).Text = "Text1(" + Format$(I) + ")"
  77.  
  78. (page 182) Code at top of page:
  79.          [object.]Line[(x1, y1)] - [x2, y2) [, color] should read
  80.          [object.]Line[(x1, y1)] - (x2, y2) [, color]
  81.  
  82. (page 184) Note, second line:
  83.          "...by pressing the ALT key." should read
  84.          "...by pressing the ESC key."
  85.  
  86. (page 204) Last paragraph, second line:
  87.         "...continuous line when mouse button..." should read
  88.         "...continuous line when the left mouse button..."
  89.  
  90. (page 223) Last paragraph, second line:
  91.         "...(named GroupChoice)..." should read
  92.         "...(named GroupList)..."
  93.  
  94. (page 261) First paragraph, second line:
  95.         "...variable-length strings." should read
  96.         "...fixed-length strings."
  97.  
  98. (page 276) Third paragraph, second line:
  99.         "KeyPress event ....The same thing happens when..." should read
  100.         "KeyDown event ...The KeyDown event gets the same code when..."
  101.  
  102. (page 313) Do Loop should read:
  103.          Do Until Instr(LastOne% + 1, Test$, "\") = 0
  104.             LastOne% = Instr(LastOne% + 1, Test$, "\")
  105.          Loop
  106.  
  107. (page 320) Last paragraph, last sentence should read:
  108.          "The maximum length of a file that can be edited with Text
  109.           Editor is a little less than 32,000 bytes, because that is
  110.           the default maximum number of characters you can assign to a
  111.           Visual Basic multiline text box control."
  112.  
  113. (page 330) Code sample seventh to last line and (page 331) second line:
  114.          "EndLine$ = Input$(1, 1)" should read
  115.          "EndLine$ = Input$(1, FileNum)"
  116.  
  117. (page 339) The Form_Load procedure:
  118.          Running this code will result in an error: "Illegal Function
  119.          call" on the statement "FieldBoxes(0).SetFocus" on the
  120.          second-to-last line. This is because the Form is not yet
  121.          visible. To solve the problem, add the following line of code
  122.          to the top of the procedure: Form1.Show
  123.  
  124. (page 360) Note at bottom of page:
  125.           References to the ALT key should be ESC key.
  126.  
  127. (page 364) The Link Execute Event, second argument, last line of
  128.          description:
  129.          "...the client receives a negative argument." should read
  130.          "...the client receives a negative acknowledgement."
  131.  
  132. (page 369) Program example:
  133.          "if Err = DDE_NO_APP"  missing THEN statement .
  134.  
  135. (page 370) "Requesting Data from Other Applications"
  136.          All references to "warm link" should be references to "cold
  137.          link".
  138.  
  139. (page 371) "Notifying Other Applications..." first paragraph:
  140.          "(in the case of a warm link)" should read
  141.          "(in the case of a cold link)".
  142.  
  143. (page 378) "To load a custom control file:"
  144.           Delete step 2 (the second line).
  145.          "Type or select the name..." should be step 2.
  146.  
  147. (page 380) Under "Special Considerations When Declaring DLL Routines":
  148.  
  149.          The statement "The Visual Basic package contains a file that
  150.          includes the declarations for all useful routines in the
  151.          operation ..." is incorrect. This file is not included with
  152.          Visual Basic, but is part of the add-on kit, "Microsoft
  153.          Windows Programmer's Reference" Book and Online Resource,
  154.          available from Microsoft at a charge.
  155.  
  156. (page 386) Code at top of page:
  157.          The first set of quotation marks around "Microsoft Excel"
  158.          should be straight quotation marks.
  159.  
  160.          Add the following paragraph after first code fragment:
  161.  
  162.         "The use of ByVal when passing a string is necessary because
  163.          the data type of that argument was declared As Any.
  164.          Including ByVal when passing a string declaring AsAny causes
  165.          Visual Basic to convert the string to the null-terminated
  166.          form expected by most DLL routines."
  167.  
  168.          The following code at the bottom of the page:
  169.          "...Lib "User"..." should read
  170.          "...Lib "GDI"..."
  171.  
  172. (Index) A, "ALT key":
  173.         Delete "interrupting DDE 360"
  174.  
  175.         A, "As Any":
  176.         Add to page list: "386"
  177.  
  178.         E, after "Errors":
  179.         Add new topic: "ESC Key, interrupting DDE 360"
  180.  
  181.         I, "Index property":
  182.         Add to page list on "creating control arrays": "117"
  183.  
  184.         M, "Microsoft Visual Basic":
  185.         Change page list on "starting programs" from "17-18" to "16-17"
  186.  
  187.         S, "Strings":
  188.         "variable-length 251, 385" should read
  189.         "use of ByVal with variable-length 251, 385, 386"
  190.  
  191. Corrections to "Microsoft Visual Basic: Language Reference"
  192. -----------------------------------------------------------
  193.  
  194. (page 9) Windows category:
  195.  
  196.        "hWin" should read
  197.        "hWnd"
  198.  
  199. (page 27) Add to the Note the following paragraph:
  200.         "When you minimize a form whose AutoRedraw Property is set to
  201.          False (0), ScaleHeight and ScaleWidth are set to icon size.
  202.          When AutoRedraw is set to True (-1), ScaleHeight and
  203.          ScaleWidth remain the size of the restored window."
  204.  
  205. (page 31) Description:
  206.         "...for an object; for forms and picture boxes..." should read
  207.         "...for an object, for forms and text boxes..."
  208.  
  209.         Add the following paragraph at the end of the Remarks section:
  210.  
  211.        "Because of appearance, the BorderStyle for forms with a menu
  212.         can only be set to Sizeable (2) or Fixed Single (1). Setting
  213.         the BorderStyle property to None (0) or Fixed Double (3)
  214.         forces the BorderStyle property to Fixed Single (1)."
  215.  
  216. (page 52) Graphic image:
  217.          The image shown is an example of a check box, it should show
  218.          a combo box example.
  219.  
  220. (page 147) Description:
  221.         "read-only" should read
  222.         "read-write"
  223.  
  224.          Change the Note to read as follows:
  225.  
  226.         "For a form icon to be functional, the BorderStyle property
  227.          must be set to either 1 (Fixed Single) or 2 (Sizeable). The
  228.          MinButton property must be set to True (-1)."
  229.  
  230.         "At runtime, you can assign an object's Icon property to
  231.          another object's DragIcon or Icon property. You can also
  232.          assign an icon returned by the LoadPicture function. Doing
  233.          this assigns an empty (null) icon, which enables you to draw
  234.          on the icon at run time."
  235.  
  236. (page 188) Last line of description should read:
  237.         "The List property is not available at design time; it is
  238.          read-only for drive, file, and directory list boxes and
  239.          read-write for combo and list boxes."
  240.  
  241. (page 209) Month Function:
  242.          In the Case statements delete all numbers greater than 12.
  243.  
  244. (page 244) Pointer Property:
  245.          This property does not exist. The name was changed to
  246.          MousePointer Property (page 214).
  247.  
  248. (page 285) Syntax:
  249.          The syntax fo ClipBoard.SetData should be changed from
  250.         "ClipBoard.SetData (data%, [format%]) to
  251.         "Clipboard.SetData data%, [format%]"
  252.  
  253.  
  254. Additional reference words: 1.00
  255.  
  256. Keywords:  docerr
  257.  
  258. COPYRIGHT Microsoft Corporation, 1991.
  259. Updated  91/07/04 02:26
  260.  
  261.